home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / util / libs / mmu.readme < prev    next >
Encoding:
Text File  |  1998-10-31  |  10.6 KB  |  238 lines
  1. Short:    Library to ctrl the MC68K MMUs, early alpha
  2. Author:   thor@math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  4. Version:  0.02
  5. Type:     util/libs
  6. Requires: Os 2.04
  7.  
  8. -----------------------------------------------------------------------------
  9.  
  10. Bugs fixed:
  11.  
  12.     -Due to a typo in the 68040/68060 startup code, the translation
  13.     control register wasn't written to the right place, leading mis-
  14.     interpretations of the library.
  15.     -The 68040 specific part did not call the 68040 table scanner, but
  16.     the 68060 stuff.
  17.     -The library clean up code did not fill in the translation control
  18.     register correctly for the 68040 and 68060.
  19.     -The library did not accept "exotic" transparent translation
  20.     settings. Unfortunately, these are not as uncommon as I believed.
  21.     Some boards seem to translate a part of the memory transparently
  22.     for read access only. I've no idea what this might be good for.
  23.     But anyways, the memory regions transparently translated are now
  24.     "mapped out" by the mmu.library and marked as unusable for
  25.     further manipulation. This means specifically that a huge part of
  26.     the available address space may be unavailable for virtual addresses.
  27.     A future version of the libray may re-introduce the integration of
  28.     the TTx registers into the mmu table, but up to then I don't like
  29.     to risk anything.
  30.  
  31. -----------------------------------------------------------------------------
  32. Warning: This is "work in progress", it's by no means complete.
  33.  
  34. I'm in the urge need for testers and co-authors. Especially MC68040 and
  35. MC68060 systems are very welcome for testing.
  36.  
  37. Please check the "ReadMe" in the archive for details how to contact me.
  38. -----------------------------------------------------------------------------
  39.  
  40. Purpose and goal of this library:
  41.  
  42. The mmu.library is a planned basis for MMU (memory management) related
  43. functions the MC68K family can perform. Up to now certain hacks are available
  44. that program the MMU themselves (Enforcer,CyberGuard,GuardianAngle,SetCPU,
  45. Shapeshifter,VMM,GigaMem...). 
  46. It's therefore not unexpected that these tools conflict with each other.
  47. There's up to now no Os support for the MMU at all - the gap this mmu.library
  48. is planned to fill.
  49.  
  50. The goal is to provide a basis of functions to address and program the MMU in
  51. a hardware independent, Os friendly fashion. Hence, a future version of the
  52. Enforcer will work together with virtual memory, and others.
  53.  
  54. The mmu.library is also the basis for a virtual memory project, the 
  55. memory.library. Even though the mmu.library does not provide virtual memory
  56. itself, it builds the basics to allow an easy implementation and to avoid the
  57. hacks required by other implementations so far.
  58.  
  59. For the design details of the mmu.library, consider reading the autodocs in
  60. this archive. Everything is still VERY preliminary, there's still room for
  61. changes and suggestions.
  62.  
  63. ------------------------------------------------------------------------------
  64.  
  65. This distribution contains the full sources written so far, the documentation
  66. and some C sample sources how to use the library, as well as the includes
  67. and autodocs written so far. Check the ReadMe for details. Even if you're not
  68. a developer, you could help me a lot by running a test program on your
  69. computer and sending me the results. Just "CD" into the unpacked archive
  70. and enter "MMUScan" and "PrintTTx", and send me the results. That's up to
  71. now all.
  72.  
  73. ------------------------------------------------------------------------------
  74. The mmu.library development group:
  75.  
  76. This is a loose, non-commercial group of developers that support the 
  77. mmu.library by their work. If you want to join, I'll setup a mailing list
  78. for the interested.
  79.  
  80. ------------------------------------------------------------------------------
  81.  
  82.                          The THOR-Software Licence (v2, 24th June 1998)
  83.  
  84.  
  85. This License applies to the computer programs known as the "mmu.library" 
  86. and its sources. The "Program", below, refers to such program. The
  87. "Archive" refers to the package of distribution, as prepared by the author
  88. of the Program, Thomas Richter. Each licensee is addressed as "you".
  89.  
  90.  
  91.  
  92. The Program and the data in the archive are freely distributable
  93. under the restrictions stated below, but are also Copyright (c)
  94. Thomas Richter.
  95.  
  96. Distribution of the Program, the Archive and the data in the Archive by a
  97. commercial organization without written permission from the author to any
  98. third party is prohibited if any payment is made in connection with such
  99. distribution, whether directly (as in payment for a copy of the Program) or
  100. indirectly (as in payment for some service related to the Program, or
  101. payment for some product or service that includes a copy of the Program
  102. "without charge"; these are only examples, and not an exhaustive enumeration
  103. of prohibited activities).
  104.  
  105.  
  106. However, the following methods of distribution
  107. involving payment shall not in and of themselves be a violation of this
  108. restriction:
  109.  
  110.  
  111. (i) Posting the Program on a public access information storage and
  112. retrieval service for which a fee is received for retrieving information
  113. (such as an on-line service), provided that the fee is not
  114. content-dependent (i.e., the fee would be the same for retrieving the same
  115. volume of information consisting of random data).
  116.  
  117.  
  118. (ii) Distributing the Program on a CD-ROM, provided that
  119.  
  120. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  121. especially this licence agreement;
  122.  
  123. b) the CD-ROM is made available to the public for a nominal fee only,
  124.  
  125. c) a copy of the CD is made available to the author for free except for
  126. shipment costs, and
  127.  
  128. d) provided further that all information on such CD-ROM is redistributable
  129. for non-commercial purposes without charge.
  130.  
  131.  
  132. Redistribution of a modified version of the Archive, the Program or the
  133. contents of the Archive is prohibited in any way, by any organization,
  134. regardless whether commercial or non-commercial. Everything must be kept
  135. together, in original and unmodified form.
  136.  
  137.  
  138.  
  139.  
  140. Limitations.
  141.  
  142.  
  143. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  144. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  145. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  146. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  147. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  148. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  149. SERVICING, REPAIR OR CORRECTION.
  150.  
  151.  
  152. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  153. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  154. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  155.  
  156.  
  157.                                                         Thomas Richter
  158.  
  159. -----------------------------------------------------------------------------
  160.  
  161. So long,
  162.     Thomas            (September 1998)
  163.  
  164.  
  165. ============================= Archive contents =============================
  166.  
  167. Original  Packed Ratio    Date     Time    Name
  168. -------- ------- ----- --------- --------  -------------
  169.     4439    1358 69.4% 13-Sep-98 12:20:32 +dos_lib.asm
  170.     2401     989 58.8% 13-Sep-98 12:20:32 +exec_lib.asm
  171.      660     233 64.6% 13-Sep-98 12:20:36 +expansion_lib.asm
  172.     3201    1331 58.4% 13-Sep-98 12:20:32 +graphics_lib.asm
  173.    19336    4605 76.1% 13-Sep-98 12:22:10 +Macros.asm
  174.      750     350 53.3% 13-Sep-98 12:20:36 +utility_lib.asm
  175.    10094    4055 59.8% 28-Jun-98 15:21:52 +implementation
  176.    14841    4911 66.9% 05-Jul-98 12:36:20 +memory.doc
  177.    26355    8478 67.8% 30-Aug-98 13:15:54 +mmu.doc
  178.     6474    1614 75.0% 19-Sep-98 12:03:10 +MMUScan.c
  179.     1475     486 67.0% 12-Sep-98 21:21:40 +mmu_protos.h
  180.     1871     611 67.3% 19-Sep-98 11:38:12 +alerts.h
  181.     2021     636 68.5% 19-Sep-98 11:38:10 +config.h
  182.     1651     571 65.4% 19-Sep-98 11:38:10 +config.h.bak
  183.     4327    1637 62.1% 19-Sep-98 11:38:10 +context.h
  184.     4155    1569 62.2% 19-Sep-98 11:38:10 +context.h.bak
  185.     1651     571 65.4% 19-Sep-98 11:38:10 +mmubase.h
  186.     1342     454 66.1% 19-Sep-98 11:38:10 +mmubase.h.bak
  187.      549     263 52.0% 12-Sep-98 21:20:32 +mmu_lib.fd
  188.     1007     346 65.6% 12-Sep-98 21:28:20 +mmu_pragmas.h
  189.      141     106 24.8% 06-Sep-98 13:37:58 +mmu.h
  190.      165     116 29.6% 06-Sep-98 13:37:52 +mmu.h.bak
  191.     1396     449 67.8% 13-Sep-98 12:19:14 +MakeFile
  192.     8857    2084 76.4% 19-Sep-98 11:37:28 +mu_030.a
  193.      752     500 33.5% 19-Sep-98 11:37:28 +mu_030.o
  194.     8745    2045 76.6% 19-Sep-98 11:37:28 +mu_040.a
  195.    12588    3038 75.8% 15-Sep-98 19:16:28 +mu_040.a.bak
  196.      772     501 35.1% 19-Sep-98 11:37:28 +mu_040.o
  197.     8771    2086 76.2% 19-Sep-98 11:37:28 +mu_060.a
  198.    12624    3069 75.6% 15-Sep-98 19:16:26 +mu_060.a.bak
  199.      760     496 34.7% 19-Sep-98 11:37:28 +mu_060.o
  200.     7686    1880 75.5% 19-Sep-98 11:37:28 +mu_851.a
  201.      576     392 31.9% 19-Sep-98 11:37:28 +mu_851.o
  202.     2174     672 69.0% 19-Sep-98 11:37:24 +mu_alerts.i
  203.     1615     455 71.8% 19-Sep-98 11:37:24 +mu_alerts.i.bak
  204.    20388    4544 77.7% 19-Sep-98 11:37:26 +mu_context.asm
  205.     5890    1688 71.3% 19-Sep-98 11:37:28 +mu_context.i
  206.     1844    1122 39.1% 19-Sep-98 11:37:26 +mu_context.o
  207.     9134    1783 80.4% 19-Sep-98 11:37:26 +mu_detect.a
  208.     4670    1370 70.6% 19-Sep-98 11:37:26 +mu_detect.a.bak
  209.      636     391 38.5% 19-Sep-98 11:37:26 +mu_detect.o
  210.    18370    4239 76.9% 19-Sep-98 11:37:24 +mu_lib.asm
  211.    10241    2608 74.5% 19-Sep-98 11:37:24 +mu_lib.asm.bak
  212.     9388    2639 71.8% 19-Sep-98 11:37:24 +mu_lib.i
  213.     6279    1881 70.0% 19-Sep-98 11:37:24 +mu_lib.i.bak
  214.     2160    1219 43.5% 19-Sep-98 11:37:26 +mu_lib.o
  215.     3941    1124 71.4% 19-Sep-98 11:37:26 +mu_loadlib.asm
  216.      428     293 31.5% 19-Sep-98 11:37:26 +mu_loadlib.o
  217.    11623    2950 74.6% 19-Sep-98 11:37:28 +mu_parse030.asm
  218.      696     551 20.8% 19-Sep-98 11:37:28 +mu_parse030.o
  219.     7385    2148 70.9% 19-Sep-98 11:37:26 +mu_parse040.asm
  220.      444     383 13.7% 19-Sep-98 11:37:28 +mu_parse040.o
  221.     7403    2159 70.8% 19-Sep-98 11:37:28 +mu_parse060.asm
  222.      444     383 13.7% 19-Sep-98 11:37:28 +mu_parse060.o
  223.    12718    2989 76.4% 19-Sep-98 11:37:26 +mu_pool.asm
  224.      996     665 33.2% 19-Sep-98 11:37:26 +mu_pool.o
  225.     4979    1409 71.7% 19-Sep-98 11:37:26 +mu_service.asm
  226.     4106    1183 71.1% 19-Sep-98 11:37:26 +mu_service.asm.bak
  227.      348     273 21.5% 19-Sep-98 11:37:26 +mu_service.o
  228.     1684     489 70.9% 19-Sep-98 11:37:24 +mu_version.i
  229.      273     207 24.1% 13-Sep-98 12:19:14 +Project-Startup
  230.       80      65 18.7% 13-Sep-98 12:19:16 +Shell-Startup2
  231.     8148    4288 47.3% 19-Sep-98 11:37:44 +mmu.library
  232.     6875    2964 56.8% 20-Sep-98 20:01:58 +mmulib.readme
  233.    15876    8440 46.8% 19-Sep-98 12:03:02 +MMUScan
  234.      728     426 41.4% 17-Sep-98 21:43:20 +PrintTTX
  235.    16254    6457 60.2% 20-Sep-98 19:59:52 +ReadMe
  236. -------- ------- ----- --------- --------
  237.   370651  116287 68.6% 22-Sep-98 22:50:42   67 files
  238.